快速开始
本页是所有接口版本共用的账号与凭证申请入口。完成后,你将获得 AccessKey 凭证,并可换取 OAuth 访问令牌,调用第一个 V3 接口。
接入前准备
- 确认你所在组织的用户管理员 可以登录高仙云平台。
- 准备一个用于接收邀请和激活邮件的邮箱。
- 确认需要调用的机器人已经绑定到对应账号,并准备好机器人序列号。
- V3 接口只确保兼容 AIO 1.6 及以上软件版本。
第一步:成为开发者
组织内邀请开发者
- 用户管理员登录高仙云平台,进入导航栏的 IAM。
- 打开 用户管理,点击右上角 添加用户。
- 输入被邀请人的邮箱,系统角色选择 开发者,业务角色按实际需要选择。
- 提交邀请,确认页面显示邀请成功。
其他组织邀请开发者
独立租户客户可以由管理员代管理其他客户组织:
- 在高仙云平台的 IAM 中打开 客户中心,输入并搜索需要代管理的客户名称。
- 在目标客户右侧进入该客户的用户管理页面。
- 点击右上角 + 用户,输入被邀请人的邮箱。
- 系统角色选择 开发者,业务角色按实际需要选择,然后提交邀请。
激活开发者账号
被邀请的开发者打开邮箱,按照激活邮件完成账号激活,然后登录开放平台。如果还没有开发者账号,请先完成上面的邀请流程。
为已有账号增加开发者角色
如果账号已经存在但没有开发者角色,用户管理员可以按以下步骤补充角色:
- 登录高仙云平台,进入 IAM > 用户管理,搜索目标账号。
- 点击账号右侧的编辑角色操作。
- 在左侧选择 开发者,将其移动到右侧的生效区域,然后点击 确定。
第二步:创建 AccessKey 并保存凭证

- 进入开发者中心左侧的 我的 AccessKey。
- 点击 创建,填写名称、描述和过期时间(支持 1 年、2 年或自定义),然后提交。

- 创建成功后,系统会同时生成 AccessKey 和应用信息。请在创建成功页面或下载内容中保存以下 4 个值:
| 凭证 | 说明 |
|---|---|
AccessKeyID | AccessKey 标识,不参与 OAuth 请求。 |
AccessKeySecret | OAuth 请求中的 open_access_key(通信密钥)。 |
ClientID | OAuth 请求中的 client_id。 |
ClientSecret | OAuth 请求中的 client_secret。 |
无需单独创建应用
原「应用管理」功能已停止使用,新创建的 AccessKey 会自动生成应用信息(ClientID 和 ClientSecret),无需再单独创建应用。
AccessKey 列表提供 续期、更新Secret、下载Secret 和 删除 操作。凭证可能只在创建成功页面或下载内容中展示一次,请在离开页面前完成保存。
密钥安全
AccessKeySecret 和 ClientSecret 只能保存在服务端或安全的密钥管理系统中。不要把凭证提交到代码仓库、前端页面、日志或工单中。
关于存量 AccessKey
AccessKey 到期前请使用 续期 延长有效期;Secret 丢失时可通过 下载Secret 或 更新Secret 重新获取。旧的 V1 AccessKey 可以升级到 V3,但升级后 ClientID 仍为空,需要继续使用原应用管理中的 ClientID。
AccessKey 凭证只区分 V1 与 V3 两个版本,不存在 V2 版本。V2 接口属于旧版 OpenAPI 体系,使用 V1 版本 AccessKey 换取的令牌即可调用。